The Business Master (3rd Edition)

home *** CD-ROM | disk | FTP | other *** search

/ The Business Master (3rd Edition) / The Business Master (3rd Edition).iso / files / utilfile / manshare / envi@103.exe / ENVI-MAN.DOC < prev next >

Wrap

Text File | 1993-04-30 | 51.7 KB | 1,499 lines

Ç ──────────────────────────────────────────── Ç ┼┐════════════════════════════════════════════ ╔╬╗ ┴ ╨║╨ ┐ ╔╩╗ ┴ ╨ ╨ ▒▒▒▒▒▒▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒█▀▀▀▀▀▀ ▒▒▒▄ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒▒▄ ▒▒▒█ ▒▒▒▒▄ ▒▒▒▄ ▒▒█ ▒▒▒▒▒▒▒▒▄ ▒▒█▒▒▄▒▒█ ▒▒▄ ▒▒█▀ ▒▒█ ▒▒▒▒▒▒▄ ▒▒▒█ ▒▒▒█ ▒▒█▀▒▒▄ ▒▒█▒▒▄▒▒█ ▒▒█▀▀▀▀▀▀ ▒▒█ ▀▒▒▒█ ▒▒▒▒█▀ ▒▒█ ▀▀▀▀▀▀ ▒▒█▒▒▄▒▒█ ▒▒▒▒▒▒█ ▒▒█ ▀▒▒▒█ ▒▒▒▒▒▒▒▒▄ ▒▒█ ▒▒█ ▒▒█▀ ▒▒█ ▒▒█▒▒█▒▒█ ▒▒█▀▀▀▒▒▄ ▒▒█ ▒▒█ ▀▀▀▀▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ Welcome to ENVI-MAN, a utility program to assist in analyzing and managing the Environment data! ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ U S E R M A N U A L Version 1.0 Release April 26, 1991 ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ Copyright 1991-1992 by Micrometric. All rights reserved. ENVI-MAN is distributed as SHAREWARE and, as such, may be copied and shared on a private non-commercial basis with others in its unmodified form. Liability is limited to replacing the software for registered users. There is no liability for any damage or loss caused by this software, directly or indirectly. ┌────────────────────────────────────────────────┐ │ ┌───────┐ │█ │ ┌────┴──┐ │ (R) │█ │ ──│ │O │─────────────────── │█ │ │ ┌────┴╨─┐ │ Association of │█ │ │ │ │─┘ Shareware │█ │ └──│ O │ Professionals │█ │ ─────│ ║ │───────────────────── │█ │ └───╨───┘ MEMBER │█ └────────────────────────────────────────────────┘█ ██████████████████████████████████████████████████ If you have problems with this program, or want to send comments, manual correc- tions, or enhancement suggestions, you may call or mail them to: Micrometric 98 Dade Avenue Sarasota, FLorida 34232-1609 USA Tech Support . . . (813) 377-2515 FAX . . . . . . . (813) 377-2091 Support BBS . . . (813) 371-2490 The Micrometric Software Support BBS provides availability and technical support for the Micrometric ■■■■-MAN series of shareware programs. First time callers have access to the board and can leave messages or download replies/current shareware releases. Registered users may also download the latest Beta test software releases, when available. Additionally, you can send routed E-Mail via the RIME(tm) network to David Groome at the ->ACTION node in the ASP, Laser, Batch, Common, or Shareware con- ferences. I also check CompuServe (71631,744), but only on an infrequent basis. PKZIP, PKUNZIP and PKSFX are trademarks of PKWARE, Inc. MS-DOS is a registered trademark of the Microsoft Corporation. IBM PC, XT, AT and PC-DOS are registered trademarks of the IBM Corporation. 2 TABLE OF CONTENTS INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Major Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Manual Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Page layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Brackets and parentheses . . . . . . . . . . . . . . . . . . . . . . 5 Computer key conventions . . . . . . . . . . . . . . . . . . . . . . 5 Action steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 ■■■■-MAN programs . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Shareware distributed documentation manual . . . . . . . . . . . . . 6 Shareware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 INSTALLING THE SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . 9 From a Diskette Vendor . . . . . . . . . . . . . . . . . . . . . . . . . 9 From a BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Registered Version . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 RUNNING ENVI-MAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Requested Environment Memory . . . . . . . . . . . . . . . . . . . . . . 15 Shareware message . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 MASTER AND PROGRAM ENVIRONMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Master Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Program Environment . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Master Environment Expansion . . . . . . . . . . . . . . . . . . . . . . 18 ENVI-MAN OPERATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Program Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Environment Data Display . . . . . . . . . . . . . . . . . . . . . . . . 22 Environment Space Remaining Display . . . . . . . . . . . . . . . . . . 23 Additional Environment Space Required Display . . . . . . . . . . . . . 23 Available Environment Space ERRORLEVEL calculation . . . . . . . . . . . 24 ENVI-MAN BATCH FILE EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 3 TABLE OF CONTENTS ENVI-MAN Version 1.0 4 INTRODUCTION ENVI-MAN is a utility that accomplishes two major function. The first is the ability to display all of the current environment strings and data about the environment such as the location, size and space availability of the Master environment. The second function is to let a batch file know how much environ- ment space is currently available and to provide a graceful exit if there is not enough. The routine may also show that, under certain circumstances, the size of the master environment can be expanded with no change being made to the CONFIG.SYS file. Major Features * Data display option showing each of the current environment strings along with its length. Summary data on the Master environment size, current envi- ronment size and available environment space is also shown. * Single line summary display option of the available environment space as reported by ERRORLEVEL. * Sets the ERRORLEVEL variable to the available environment space for use in testing within batch files. * Option to calculate the available environment space with or without possible free memory located above the master environment. * Option to compare and test the available environment space with a requested amount of needed environment memory. * May be run from the DOS prompt to display data or from a batch file to test available environment space. * Written in assembler for fast operation and small size. System Requirements ENVI-MAN will run on an IBM PC, XT, AT or true compatibles. It has been tested with PC-DOS/MS-DOS operating systems, version 3.0 through version 5.0. Manual Format This manual is divided into several introductory chapters followed by a chapter for each ENVI-MAN function menu. The format of these chapters, and the informa- tion presented therein, has been standardized using the following conventions. Page layout - Each page has a header detailing the chapter and the program ver- sion covered. A footer displays the manual page number. Brackets and parentheses - Brackets, [...], are used in the manual and in the help screens to specify what should be entered in response to the current prompt. If a character string is to be entered, the type of character is noted, such as ALPHA, NUMERIC, ANY, etc. Parentheses, (..), are used for comments. Computer key conventions - Keys specified in the manual text that are not in entry brackets are shown as reversed text, such as ESCAPE . All key references are in capital letters for clarity. Action steps - Some procedures may require selection from a menu of options, inputting data, or following a sequence of operations. Most manual sections will first give an overview of the function or task under discussion and then detail 5 INTRODUCTION ENVI-MAN Version 1.0 the various action operating procedures. In order to make this manual easier to use, a symbol, -> , marks the beginning of each of these action operating proce- dures. ■■■■-MAN programs - The general group of shareware programs by Micrometric is referred to by the name ■■■■-MAN. It may also be used in reference to a specific program in that group. Shareware distributed documentation manual - The documentation file included on the shareware distribution diskette contains the same information as the printed and bound manual, supplied as part of registration, with two exceptions, the result of the word processor, formatting, and printer used. The first is that all of the control display characters (ASCII 1-31) and the reverse print key- board codes are NOT shown properly. Finally, bolding, underlining, and special symbols are NOT present. Shareware ENVI-MAN is being distributed as SHAREWARE. The SHAREWARE concept allows users to examine a program on a trial basis, at no (or minimal) charge, before pur- chasing it. In addition, by decreasing marketing costs, professional quality software may be distributed for a fraction of the cost of a comparable commer- cial product. Regardless of whether you register the program, please help dis- tribute ENVI-MAN by sharing unmodified copies of it and its files with others. You are hereby granted the right to use the ENVI-MAN program for a thirty (30) day evaluation period. If you find ENVI-MAN of value, and continue to use it after this evaluation period, YOU MUST REGISTER YOUR PROGRAM USE. This will provide you with: * A 7" x 8 1/2" printed and bound manual. * ENVI-MAN phone or mail support for one year. * Notification of the next ENVI-MAN release. * Ability to suppress the shareware registration reminder message displayed at the end of the program. * An installation/update/registration brand program. * Sincere thanks for your support of the SHAREWARE concept. A Single System Program Registration entitles the user to unlimited use of the ENVI-MAN program on a single computer. A Site License Program Registration entitles the user to unlimited use of the ENVI-MAN program on all computers, including networks, at a single corporate location. 6 ENVI-MAN Version 1.0 INTRODUCTION Program Registration, Single System . . . $20. Includes latest version diskette and manual Program Registration, Site License . . . $200. Includes latest version diskette and manual Latest Version Diskette only . . . . . . $10. Shipping - Surface (for outside of USA/Canada only)$5. Shipping - Air (for outside of USA/Canada only)$10. COD and credit card orders, add 5% Florida residents, add 7% sales tax ADDRESS: Micrometric 98 Dade Avenue Sarasota, FLorida 34232-1609 USA PHONE: Tech Support . . (813) 377-2515 FAX . . . . . . . (813) 377-2091 Support BBS . . . (813) 371-2490 Order Line . . . (800) 929-0184 For ease in program registration, a registration order form is included with the distribution files. This program is produced by a member of the Association of Shareware Profession- als (ASP). ASP wants to make sure that the shareware principal works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427, send a CompuServe message via easyplex to ASP Ombudsman 70007,3536, or by FAX to the ASP FAX number: (616) 788-2765. In communications with the Ombudsman please include a telephone number and/or FAX if available. 7 INTRODUCTION ENVI-MAN Version 1.0 8 INSTALLING THE SYSTEM From a Diskette Vendor If the ENVI-MAN program has been obtained from a diskette vendor, you should follow any of their instruction on unpacking/installing the programs (if indeed they have separate instructions.) The program, and its files, is normally sup- plied as a self extracting file whose name is "ENVI@xxx.EXE" (xxx is the ver- sion, such as "ENVI@100"). This file should first be copied to a directory on your hard disk. This direc- tory may be a new one, such as one named "ENVI", and created specifically for ENVI-MAN, or a current one, such as "UTILITY", that has other programs/files. For information on creating a separate directory, see your DOS manual. NOTE FOR BEST OPERATION, ALL REQUIRED ENVI-MAN FILES *SHOULD* BE PLACED ON PATH REFERENCED SUBDIRECTORIES! Once the file is copied to the desired hard disk directory, at the DOS prompt change to this drive directory, and then type the EXE file name (such as "ENVI@100") and press ENTER . This will unpack all of the ENVI-MAN files. From a BBS If the ENVI-MAN file was downloaded from a Bulletin Board, it should first be copied to a directory as defined above, and then unpacked, using whatever pro- gram is specified by the Bulletin Board. It is normally distributed with a name of "ENVI@vvv.ZIP" (vvv is the version) or "ENVIMN.ZIP". Registered Version Registered users should use the program "INSTALL", that is supplied upon regis- tration. This program will create a registration file which will, in turn, sup- press the shareware registration reminders. -> To install ENVI-MAN on your hard disk, follow the steps detailed below: 1. Place the ENVI-MAN distribution diskette in your floppy diskette drive. 2. At the DOS prompt, change to the drive in which the distribution diskette is located. For example, if the diskette was placed in drive A, type A : and press ENTER . 3. Type I N S T A L L and press ENTER . The installation pro- gram will then be loaded, and its display should be as shown below. 9 INSTALLING THE SYSTEM ENVI-MAN Version 1.0 ╒═╡ INSTallation MANagement Program/One System Started at═>07-31-92 03:00 ╞═╕ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░ ░░▄ ░░▄ ░░▄░░░░░░░░▄░░░░░░░░▄ ░░▄ ░░▄ ░░▄ ░░▄ ░░▄░│ │░ Ç═ ░░█ ░░░▄ ░░█░░█▀▀▀▀▀▀ ▀▀░░█▀▀▀ ░░▄ ░░░▄ ░░░█ ░░░░▄ ░░░▄ ░░█░│ │░ ┌┼┐ ░░█ ░░█░░▄░░█░░░░░░░░▄ ░░█ ░░░█ ░░░█ ░░░█ ░░█▀░░▄ ░░█░░▄░░█░│ │░ ┌┴┐ ░░█ ░░█ ▀░░░█ ▀▀▀▀▀░░█ ░░█ ░░█ ░░█░░▄░░█ ░░░░░░█ ░░█ ▀░░░█░│ │░═┴═┴═░░█ ░░█ ░░█░░░░░░░░█ ░░█ ░░░░▄ ░░█░░█░░█░░█▀▀▀░░▄░░█ ░░█░│ │░ ▀▀ ▀▀ ▀▀ ▀▀▀▀▀▀▀▀ ▀▀ ▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀░│ ╘╡ INSTALL/1 Version 3.00 Copyright 1990-92 Micrometric, All Rights Reserved ╞╛ F1>Help│ESC>Exit│ENTER/[char]>Select│ HomeEnd│ NOTE Context sensitive help is available from this point in the installa- tion program on, by pressing the F1 key. 4. If a color video card is detected, the following prompt will be displayed. ┌──────────────────────────────────────┐ │ ╔═╡ Color Monitor Card Detected ╞═╗ │ │ ║ Use the color display ║█ │ │ ║ Force a monochrome display ║█ │ │ ╚═════════════════════════════════╝█ │ │ ███████████████████████████████████ │ └──────────────────────────────────────┘ -> If your system has a color monitor, press U . -> If your system has a monochrome or LCD display, press F . 5. A selection list of all path referenced directories is next displayed. NOTE FOR BEST OPERATION, ALL REQUIRED ENVI-MAN FILES *SHOULD* BE PLACED ON PATH REFERENCED SUBDIRECTORIES! 10 ENVI-MAN Version 1.0 INSTALLING THE SYSTEM ┌────────────────────────────────────────────┐ │ ┌─┤ Select the INSTALLATION DIRECTORY ├─┐ │ │ │ C:\BAT │█ │ │ │ C:\DOS-500 │█ │ │ │ C:\UTILITY │█ │ │ │ C:\ZIP │█ │ │ │ C:\ │█ │ │ │ User Defined Drive-Directory Path │█ │ │ └───────────────────────────────────────┘█ │ │ █████████████████████████████████████████ │ └────────────────────────────────────────────┘ -> To cancel the installation program at this point, press ESCAPE . -> To select one of the path referenced directories on which to install ENVI-MAN, move the highlight bar to the desired one and press ENTER . -> To specify a non-path referenced directory on which to install ENVI-MAN, press U and then press ENTER . A data entry window for the installation path will then be displayed, as shown below (with an exam- ple path already entered). Enter the desired drive and directory path on which to install ENVI-MAN, using the control keys described on the bottom help line. ┌────────────────────────────────────────────────────────────────────────┐ │ ┌─┤ Enter Path ├────────────────────────────────────────────────────┐ │ │ │ C:\ENVI.......................................................... │█ │ │ └───────────────────────────────────────────────────────────────────┘█ │ │ █████████████████████████████████████████████████████████████████████ │ └────────────────────────────────────────────────────────────────────────┘ -> To cancel defining the path, press ESCAPE . The program will return to directory selection. -> To accept the path as entered and edited, press ENTER . If the specified directory does not currently exist, the following message will be displayed. ┌────────────────────────────────────────────────────────────────────┐ │ ┌─┤ MESSAGE ├───────────────────────────────────────────────────┐ │ │ │ The drive-directory path as entered DOES NOT currently exist. │█ │ │ │ This directory WILL NOW BE created. │█ │ │ └───────────────────────────────────────────────────────────────┘█ │ │ █████████████████████████████████████████████████████████████████ │ └────────────────────────────────────────────────────────────────────┘ -> To cancel creation of this directory, press ESCAPE . -> To create the specified directory, press ENTER . If the speci- fied drive is invalid or the requested installation directory's parent does not exist, an error message will be displayed. Press any key, and then re-edit the installation path. 6. If more than one system is available for installation, a SYSTEM TO INSTALL selection menu will be displayed, as shown below. 11 INSTALLING THE SYSTEM ENVI-MAN Version 1.0 ┌─────────────────────────────────────────────────────────────────────┐ │ ╔═══╡ Select the SYSTEM TO INSTALL ╞═════════════════════════════╗ │ │ ║ ENVI-MAN Environment data summary, environ. space remaining ║█ │ │ ║ FILE-MAN Menu driven DOS file manager, directory tree ║█ │ │ ║ LASR-MAN Print text files on a laser printer, 36 print styles ║█ │ │ ║ MENU-MAN Display custom user selection menus from batch files ║█ │ │ ║ PATH-MAN Determines if a file is on a PATH directory ║█ │ │ ╚════════════════════════════════════════════════════════════════╝█ │ │ ██████████████████████████████████████████████████████████████████ │ └─────────────────────────────────────────────────────────────────────┘ -> To terminate the installation program at this point, press ESCAPE . -> To select the SYSTEM TO INSTALL, press its highlighted letter or move the highlight bar to in with the arrow keys and press ENTER . 7. A list of all ENVI-MAN files is next displayed, along with an INSTALLATION FUNCTION menu. The normal sequence of operations is to first "Install" the ENVI-MAN program and files, and then "Brand" the system with your name and serial number. ┌─────────────────────────────────────────────────────────────┐ │ ╒═╡ Select the INSTALLATION FUNCTION ╞═══════════════════╕ │ │ │ Install system Brand system eXit │█ │ │ ╘════════════════════════════════════════════════════════╛█ │ │ ██████████████████████████████████████████████████████████ │ └─────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────────────┐ │╒═╡ File Name Status Hard Disk Path/File Description ENVI-MAN FILES ╞═╕ │ ││ System═>ENVI-MAN Environment data summary, environ. space remaining │█│ ││ ENVI-MAN.COM PROCESS Utility program │█│ ││ YYYY.YYY PROCESS Other files │█│ │╘═╡ INSTALLATION PATH═>C:\ENVI ╞════════════════════════════════════════════╛█│ │ █████████████████████████████████████████████████████████████████████████████│ └──────────────────────────────────────────────────────────────────────────────┘ -> To install ENVI-MAN on the hard disk, insure that the highlight bar is on the "INSTALL SYSTEM" FUNCTION and press ENTER . Each of the file(s) will be copied to the selected installation drive-directory. NOTE A happy face symbol after any of the system's file names de- notes that this file is already on the hard disk. During in- stallation it will be replaced, on the directory where it currently resides, not the INSTALLATION DRIVE-DIRECTORY PATH. When all files have been copied to the hard disk, a copy complete mes- sage is displayed. 12 ENVI-MAN Version 1.0 INSTALLING THE SYSTEM ┌───────────────────────────────────────────────────────────────┐ │ ┌─┤ MESSAGE ├──────────────────────────────────────────────┐ │ │ │ FILE COPY COMPLETED. │█ │ │ │ All of the required BOOK-IT! files are on the hard disk. │█ │ │ │ ═══> BOOK-IT! IS READY TO RUN. <═══ │█ │ │ └──────────────────────────────────────────────────────────┘█ │ │ ████████████████████████████████████████████████████████████ │ └───────────────────────────────────────────────────────────────┘ -> To cancel the installation at this point, press ESCAPE . -> To continue with the installation, press any other key. The high- light bar will then be on the "BRAND SYSTEM" FUNCTION. 8. -> To brand the system with your name and serial number, move the high- light bar to the "BRAND SYSTEM" FUNCTION and press ENTER . A REGISTRA- TION INFORMATION data entry window will be displayed, as shown below, with sample data already entered. NOTE This step is REQUIRED for ENVI-MAN to be registered. Also, if you move the ENVI-MAN files to another drive-directory you will need to "BRAND" the system again. Enter your company and/or your name, and then the system registration number. Your registration number is located on the back of the front cover of this manual. ┌──────────────────────────────────────────┐ │ ┌─┤ REGISTRATION INFORMATION ├────────┐ │ │ │ Name ABC COMPANY, George Jones │█ │ │ │ Registration number 12345678 │█ │ │ └─────────────────────────────────────┘█ │ │ ███████████████████████████████████████ │ └──────────────────────────────────────────┘ -> To accept either the name or registration number after entry and editing, press ENTER . A message will be displayed after the regis- tration number is entered. It's contents are dependent on whether the registration number is valid. Both messages are shown below. ┌───────────────────────────────────────────────┐ │ ┌─┤ MESSAGE ├──────────────────────────────┐ │ │ │ BOOK-IT! serial number entered is VALID. │█ │ │ └──────────────────────────────────────────┘█ │ │ ████████████████████████████████████████████ │ └───────────────────────────────────────────────┘ ┌─────────────────────────────────────────────────┐ │ ┌─┤ MESSAGE ├────────────────────────────────┐ │ │ │ BOOK-IT! serial number entered is INVALID! │█ │ │ │ Please try again. │█ │ │ └────────────────────────────────────────────┘█ │ │ ██████████████████████████████████████████████ │ └─────────────────────────────────────────────────┘ 13 INSTALLING THE SYSTEM ENVI-MAN Version 1.0 -> To continue with the installation program, press any key. If the registration number was valid, the "EXIT" option is highlighted. If it was invalid, select the "BRAND SYSTEM" option again. 9. -> To exit from the installation program, move the highlight bar to the "EXIT" FUNCTION and press ENTER . If the system has been properly branded, the program will exit, and ENVI-MAN is ready for use. If the system has not been branded, an error message is displayed, as shown below. ┌─────────────────────────────────────────────────────────────────┐ │ ┌─┤ MESSAGE ├────────────────────────────────────────────────┐ │ │ │ This system has not been 'BRANDED'. │█ │ │ │ In order to be registered, it must first be 'BRANDED'! │█ │ │ │ To exit without BRANDING, press ESCAPE. │█ │ │ │ To continue with the INSTALL program, press any other key. │█ │ │ └────────────────────────────────────────────────────────────┘█ │ │ ██████████████████████████████████████████████████████████████ │ └─────────────────────────────────────────────────────────────────┘ 14 RUNNING ENVI-MAN The syntax to execute the ENVI-MAN utility program is: ENVI-MAN [option a] [option ...] [requested environment memory] The command line options provide information to ENVI-MAN that will override the default options that are in effect at the beginning of the program. A space MUST be present after the program name and any command line parameters. Spaces between options and requested environment memory are optional. Options none If no options or requested environment memory are specified ENVI-MAN will display the program syntax. + Calculate the Available Environment Space using the Master Environment Size and any currently free memory available immediately above the Master Environment. Set the DOS ERRORLEVEL variable equal to the value calculated using the rules detailed in the section "Available Environment Space ERRORLEVEL Calculation". This is the default. - Calculate the Available Environment Space using only the Master Environ- ment Size. Set the DOS ERRORLEVEL variable equal to the value calculated using the rules detailed in the section "Available Environment Space ERRORLEVEL Calculation". s Display a single summary line specifying the Available Environment Size and the value to which ERRORLEVEL is set. This display does not cause a pause nor is any user action required. d Displays each of the current environment strings along with its length. Additionally data is displayed about the master environment size, free memory above the master environment, current environment size, available environment space and the value of ERRORLEVEL. x Suppress the error message display on Insufficient Environment Space re- maining. Requested Environment Memory nnnnn (0-32767) If a numeric value is placed on the command line, it will be treated as a request to test for the availability of a corresponding num- ber of bytes of environment space. This number will then be used in the calculation of the ERRORLEVEL variable using the rules detailed in the section "Available Environment Space ERRORLEVEL Calculation". Shareware message A shareware message may be randomly displayed at the end of ENVI-MAN. Pressing any key will exit the program. The use of the "X" option to suppress display of the Insufficient Environment 15 RUNNING ENVI-MAN ENVI-MAN Version 1.0 Space Remaining will not affect the shareware message display. By registering you use of ENVI-MAN, you will be able to use the registration serial number to suppress the shareware message display. 16 MASTER AND PROGRAM ENVIRONMENTS Master Environment When the computer is first booted, a Master Environment is established. Its default size is 160 bytes for DOS versions 3.x and 4.x and 256 bytes for version 5.0. This size may be changed, in sixteen byte increments up to a maximum size of 32,767, by use of the SHELL and COMMAND statements in the CONFIG.SYS file. Details of these commands may be found in the DOS manual. For any changes to the CONFIG.SYS file to become effective, the system must be re-booted after the changes are made. The contents of the Master Environment are environment strings, each in the following format: NAME = STRING[ASCII 0] As can be seen from the format, the minimum environment string length is four bytes. An example environment string is - PATH=C:\ The length of the above example is nine bytes. The Master Environment strings may be created or changed by use of the DOS com- mands such as PROMPT, PATH and SET. An example would be- SET GOOD=EMPIRE SET BAD=KLINGONS PROMPT=$P$G Program Environment When a program is executed, the loader (which is called by COMMAND.COM and is DOS Int 21h - EXEC), establishes a copy of the environment for use by the pro- gram. It first copies all of the environment strings from the Master Environ- ment(or, if this is a child process, from the parent's environment). These envi- ronment strings are then terminated by a three character sequence of: [ASCII 0][ASCII 1][ASCII 0] The environment strings are followed by the complete path of the loaded program using the format: D:\[subdirectory path\]NNNNNNNN.EEE[ASCII 0] where: D:\ disk drive from which the program is being loaded, subdirectory path\ path of the program being loaded, NNNNNNNN name of the program, .EEE extension of the program. 17 MASTER AND PROGRAM ENVIRONMENTS ENVI-MAN Version 1.0 The program environment is then sized up to a paragraph boundary so that its size in bytes is always a multiple of sixteen. Master Environment Expansion One interesting fact is that the size of the Master Environment may, under cer- tain circumstances, exceed its default size or the size defined in CONFIG.SYS. The Master environment is preceded by a 16 byte Memory Control Block (MCB) which give the memory block size and the address of its owner. If the address is zero, the memory block is free. In some cases while booting, Terminate and Stay Resident (TSR) programs are loaded. Their program environment is allocated before the program is loaded. Some TSR's will release their environment memory allocation before returning control to the command processor. If the size of the environment does not grow, these free memory holes can be used to load the environment for later TSR's or other programs. However, if the size of the environment does increase, there may be few uses for these free memory areas and they may remain unused. In the situation just described, memory allocation in the area of the Master Environment might look as detailed below. ENV_SIZE is the default or defined value for the Master Environment. Memory Control Block 1 (=16 bytes) {OWNER=COMMAND.COM} {MEMORY_SIZE=ENV_SIZE} Master Environment (=ENV_SIZE bytes) Memory Control Block 2 (=16 bytes) {OWNER=FREE} {MEMORY_SIZE=X} Free Memory (=X bytes (a multiple of 16)) Memory Control Block 3 (=16 bytes) {OWNER=SOMEONE} {MEMORY_SIZE=Z} Note that MCB 2 and its associated memory block are free. Now for the fun part! If a request is made to COMMAND.COM to increase the size of the environment, such as with a SET statement and the size of the new environment would then exceed that as defined by ENV_SIZE, it WILL NOT display "Out of environment space". Rather, it will obtain the needed memory from MCB 2 and its associated block. Lets assume that there was a Master Environment (ENV_SIZE) of 160 bytes, the current length of the environment strings was 155 bytes and the SET command will add 10 bytes to the size of the environment strings. COMMAND.COM will: 18 ENVI-MAN Version 1.0 MASTER AND PROGRAM ENVIRONMENTS 1. Increase the size of the memory block specified in MCB 1 by 16 bytes. 2. This increases the size of the Master Environment by 16 bytes. 3. Relocate MCB 2 16 bytes higher and decrease the size of its memory block by 16 bytes. 4. This decreases the size of the free memory block associated with MCB 2 by 16 bytes. This area of memory will now look like: Memory Control Block 1 (=16 bytes) {OWNER=COMMAND.COM} {MEMORY_SIZE=ENV_SIZE+16} Master Environment (=ENV_SIZE+16 bytes) Memory Control Block 2 (=16 bytes) {OWNER=FREE} {MEMORY_SIZE=X-16} Free Memory (=X-16 bytes (a multiple of 16)) Memory Control Block 3 (=16 bytes) {OWNER=SOMEONE} {MEMORY_SIZE=Z} This procedure can continue - Master Environment increasing by 16 bytes and Free Memory and its MCB 2 decreasing by 16 bytes - until both the Free Memory AND MCB 2 have been incorporated into the Master Environment! Note that MCB 3 is not involved, since, if MCB 3 pointed to a free memory block, it would normally be incorporated into MCB 2. However, if MCB 3 did point to free memory, it could eventually be used by the Master Environment after all of MCB 2 and its free memory was used. 19 MASTER AND PROGRAM ENVIRONMENTS ENVI-MAN Version 1.0 20 ENVI-MAN OPERATION Program Syntax A program syntax message is displayed if: * No command line parameters are specified. Or, * Any of the command line parameters is invalid. The program syntax message is shown below. ┌─────────────────────────────────────────────────────────────────────────────┐ ┌┤ ENVI-MAN Version 1.02, Copyright 1991-92 Micrometric, All rights reserved ├┐ │The program syntax is: ENVI-MAN [options][requested environment memory] │ │ options = none, display syntax │ │ +, calculate ERRORLEVEL using Free Memory Above Master (default)│ │ -, calculate ERRORLEVEL using only Master Size │ │ d, display Environment Data │ │ s, display Environment Space Remaining Summary line │ │ x, suppress displays including Insufficient Environment Message │ │ requested = nnnnn, optional decimal bytes of environment memory needed │ │ERRORLEVEL = AVAILABLE ENVIRONMENT SPACE + Free(optional) - Requested(opt.) │ │ = 0, no Environment Space Remaining │ │ = 1-254, bytes Environment Space Remaining │ │ = 255, greater that 254 bytes Environment Space Remaining ┴ └────────────────────────────────┤ ENVI-MAN syntax, Press any key to continue.. └─────────────────────────────────────────────────────────────────────────────┘ -> If this message is displayed, correct the program syntax and rerun. 21 ENVI-MAN OPERATION ENVI-MAN Version 1.0 Environment Data Display ENVI-MAN has two major functions: an informational one and a testing one. The Environment Data Display is its primary informational tool. To obtain the Environment Data Display, use the syntax - ENVI-MAN D A sample of the resulting Environment Data Display is shown below. An explana- tion of its information follows. ┌─────────────────────────────────────────────────────────────────────────────┐ ┌┤ ENVI-MAN Version 1.02, Copyright 1991-92 Micrometric, All rights reserved ├┐ │ COMSPEC=C:\DOS\COMMAND.COM ─> 27 │ │ DOS=DOS-330 ─> 12 │ │ PATH=C:\BAT;C:\DOS-330;C:\UTILITY;C:\ ─> 38 │ │ PROMPT=$e[36;44;1m$t$h$h$h$h$h$h $d$h$h$h$h$h $p$g$e[37;44;1m ─> 62 │ │C:\UTILITY\ENVI-MAN.COM ─> 24 │ └─────┤ Current Environment Strings ─> String Length ├────────────────────────┘ │ Master Environment Location <> 0E36:0000 │ │ MASTER ENVIRONMENT SIZE ═> 320 │ │ Free Memory Above Master +> 80 │ │ POSSIBLE MASTER ENVIRONMENT SIZE ≈> 400 │ │ Number Of Environment Strings <> 4 │ │ Environment Strings Length +> 140 │ │ Program Path Length +> 26 │ │ Current Environment Size ═> 176 │ │ AVAILABLE ENVIRONMENT SPACE ═> 180 │ │ POSSIBLE AVAIL ENVIRONMENT SPACE ≈> 260 │ │ Requested Environment Memory ─> 0 │ │ ERRORLEVEL SET TO ═> 255, Press any key to continue.. │ └─────────────────────────────────────────────────────────────────────────────┘ The program line shows the current ENVI-MAN version. The boxed lines, except for the last, are the current Master Environment and Program Environment strings. At the end of each string is its length, which includes its terminating zero byte. The last boxed line is the program path that is included in the Program Environ- ment. At its end is its length, including its terminating zero byte. MASTER ENVIRONMENT LOCATION . . . . The segment address and offset (always zero) at which the Master Environment is located. Its MCB is located one paragraph lower. MASTER ENVIRONMENT SIZE . . . . The current Master Environment size, not neces- sarily the default or defined size. FREE MEMORY ABOVE MASTER . . . . . The size of any contiguous free memory in- cluding its associated MCB above the Master Environment. POSSIBLE MASTER ENVIRONMENT SIZE . The possible maximum size of the Master Environment if the currently available free memory is included. NUMBER OF ENVIRONMENT STRINGS . The number of currently defined environment strings. 22 ENVI-MAN Version 1.0 ENVI-MAN OPERATION ENVIRONMENT STRINGS LENGTH . . The size of all of the currently defined envi- ronment strings. This size includes the strings termination zero byte, since this byte is required in the Master Environment. PROGRAM PATH LENGTH . . . . . . The length of the program path string in the Program Environment. This size includes the termination zero byte and the two bytes that separate the environment strings from the program path. CURRENT ENVIRONMENT SIZE . . . . . The size of the current environment. This size set by COMMAND.COM and is always a multiple of 16 bytes. AVAILABLE ENVIRONMENT SPACE . . . . Currently defined MASTER ENVIRONMENT SIZE less the currently defined ENVIRONMENT STRINGS LENGTH. The available free space in the currently defined Master Environment. POSSIBLE AVAIL ENVIRONMENT SPACE . The AVAILABLE ENVIRONMENT SPACE plus the FREE MEMORY ABOVE MASTER Environment space. REQUESTED ENVIRONMENT MEMORY . The amount of environment memory needed as requested in the ENVI-MAN command line parameters. ERRORLEVEL SET TO . . . . . . . . . The value calculated by ENVI-MAN to which the ERRORLEVEL variable is set upon program exit. For the formula used for this calculation, see the section "AVAILABLE ENVIRONMENT SPACE ERRORLEVEL CALCULATION" later in this chapter. Environment Space Remaining Display To display a single summary line on the environment space status, use the syntax - ENVI-MAN S An example of the resulting display is shown below. For the formula used for this calculation, see the section "AVAILABLE ENVIRONMENT SPACE ERRORLEVEL CALCU- LATION" later in this chapter. ┌─────────────────────────────────────────────────────────────────────────────┐ │ Environment Space Remaining ═> 255 │ └─────────────────────────────────────────────────────────────────────────────┘ Additional Environment Space Required Display If, based on the defaults and the command line parameters, there is not suffi- cient environment space remaining, an informational message is displayed, as shown below. This message ONLY appears if reserved memory has been specified on the command line AND the "X" suppress option is NOT specified. ┌─────────────────────────────────────────────────────────────────────────────┐ ┌┤ ENVI-MAN Version 1.02, Copyright 1991-92 Micrometric, All rights reserved ├┐ │The amount of Additional Environment Memory requested for this batch file is │ │greater than the currently available Environment Space. This means that if │ │execution of this batch file continued, the operating system would display │ │the message "out of environment space" and terminate the batch file. In order│ │to run this batch file (assuming no free memory above the Master Environment)│ │you MUST decrease the environment strings length OR increase the size of the │ │ENVIRONMENT space using the SHELL statement in your CONFIG.SYS file. ┴ └──┤ Additional Environment Space Required ═> 120, Press any key to continue..│ └─────────────────────────────────────────────────────────────────────────────┘ The displayed "Additional Environment Space Required" NEVER includes any possi- 23 ENVI-MAN OPERATION ENVI-MAN Version 1.0 ble free memory above the Master Environment. This is the amount by which the defined environment size should be increased in order to run the program with the desired environment information. Possible free memory is not used since this value is how much the Master Environment needs to be increased. The Master Environment size may be changed, in sixteen byte increments up to a maximum size of 32,767, by use of the SHELL and COMMAND statements in the CONF- IG.SYS file. Details of these commands may be found in the DOS manual. For any changes to the CONFIG.SYS file to become effective, the system must be re-booted after the changes are made. If sufficient environment space was not available, this message WOULD BE dis- played with the syntax - ENVI-MAN 2000 and WOULD NOT BE displayed with the syntax - ENVI-MAN 2000X Available Environment Space ERRORLEVEL calculation The ERRORLEVEL variable is used to denote the amount of Available Environment Space and is calculated as follows: ERRORLEVEL = Master Environment Size - Environment Strings Size + Free Memory Above Master Environment (optional) - Requested Environment Memory (optional) If ERRORLEVEL is negative (there is not enough Available Environment Space), it is set equal to zero to denote an error condition. If ERRORLEVEL, as calculated, is equal to zero (there is exactly enough current Available Environment Space), it is set equal to one to denote a non-error condition. If ERRORLEVEL is greater than 254, it is set equal to 255. A summary of the various ERRORLEVEL values and their relationship to the Avail- able Environment Space is shown below. ERRORLEVEL Available Environment Space 0 -32767 to -1 1 0 to 1 2-254 Same as ERRORLEVEL 255 255 to 32767 24 ENVI-MAN BATCH FILE EXAMPLES Shown below are several examples of the use of ENVI-MAN in batch files. -> To assure that an environment variable of 8 character storage size may be added and to display your own message if there is insufficient space, use the following batch file code: ... ENVI-MAN +8X (or ENVI-MAN 8X) IF NOT ERRORLEVEL 1 GOTO NOFIT ... :NOFIT ECHO DO THIS AND THAT BECAUSE ECHO THERE IS NOT ENOUGH SPACE ECHO IN THE ENVIRONMENT. ... The batch file code shown below will produce the same results at that above (without the requested environment memory parameter the "Additional Environment Space Required Display" can never occur and thus the "X" sup- press option is not needed): ... ENVI-MAN + IF NOT ERRORLEVEL 8 GOTO NOFIT ... :NOFIT ECHO DO THIS AND THAT BECAUSE ECHO THERE IS NOT ENOUGH SPACE ECHO IN THE ENVIRONMENT. ... -> To assure that an environment variable of 8 character storage size may be added and let ENVI-MAN display a message if there is insufficient space, use the following batch file code: ... ENVI-MAN +8 (or ENVI-MAN 8) IF NOT ERRORLEVEL 1 GOTO EXIT ... :EXIT ... -> To display the amount of available environment space on a single line, use the following batch file code: ... ENVI-MAN +S (or ENVI-MAN S) ... 25 ENVI-MAN BATCH FILE EXAMPLES ENVI-MAN Version 1.0 -> To display the environment data, use the following code (this syntax may be used in a batch file or entered at the DOS prompt): ENVI-MAN D 26